home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 5 #8 / IMG 51 Vol 5-8.iso / Goodies / More For Your Games / Close Combat / Utilities / CC Landscaper v 1.1 / README < prev   
Text File  |  1997-06-26  |  10KB  |  221 lines
  1. ---------------------------------------------------------------------------
  2.   *    Close Combat Landscaper v 1.1.0
  3.   *    June 26, 1997
  4.   *    Matthew Hills
  5.   *      hills@biosensors.stanford.edu
  6.   *
  7.   *    Support Site:  http://www-leland.stanford.edu/~hills/games.html
  8. ---------------------------------------------------------------------------
  9.      
  10. Introduction:
  11. =============
  12.  
  13.   Close Combat Landscaper (hereafter "CCLand") is an editor for the
  14.   Macintosh version of Close Combat (written by Atomic Games, published by
  15.   Microsoft, 1996).
  16.   
  17.   PLEASE NOTE:  this product is not supported by either Atomic or
  18.                 Microsoft -- do not send them questions about it.
  19.                 
  20.   This editor allows the user to change the tile graphics used in Close Combat.
  21.   Please refer to the other documentation and utilities on my web site for
  22.   more information on editing Close Combat scenarios.
  23.                          
  24. Version 1.1:
  25. ============
  26.  
  27.   I've added the Import/Export commands from the file menu.
  28.   Now you are able to export the entire terrain tiles file as one large pict
  29.   and then import it back in again.  This facilitates large-scale changes to
  30.   the tile set.
  31.  
  32.   To aid in color-matching, there is now a command to export the color table
  33.   as a picture file.  The picture is not very exciting -- 256 splotches of
  34.   color.  My intention here was that you could use this as a palette and
  35.   select colors using an eyedropper-type tool.
  36.  
  37.   Please note that when importing the picture back in, it should be the same
  38.   size as when you exported it.  (The graphics will scale to fit, resulting
  39.   in some distortion.)
  40.  
  41.   Also, note that the picture files are pretty large (1.7 megs).  The default
  42.   memory allocation for CC Land should be sufficient to handle one open terrain
  43.   tiles document and still import/export... but you may need to increase memory
  44.   if you get too carried away.
  45.  
  46.  
  47. Basic Instructions:
  48. ===================
  49.  
  50.   You should have Close Combat set up to run entirely from the hard drive.
  51.   (You can find instructions for this on my web site)
  52.  
  53.   When you run CCLand, you can open the "Terrain Tiles" file that is usually
  54.   stored inside the "Graphics" folder within the Microsoft Close Combat folder.
  55.   
  56.   When a Tiles file is opened, you will be presented with all 1170 terrain
  57.   tiles that Close Combat has.  The currently selected tile is highlighted in
  58.   an attractive yellow color.  The index number for this tile is also displayed
  59.   at the top of the window (this is useful for later reference as well as for
  60.   indexing against the Close Combat data files).
  61.   
  62.   The program operation is relatively straightforward:  select a tile and "copy"
  63.   it.  You can then "paste" the tile graphic into most drawing/painting programs.
  64.   Once you are satisfied with your artistic endeavors, copy the graphic and paste
  65.   it back in using CCLand. Whee!  That sure was fun.  1169 to go!
  66.   
  67. Special Notes:
  68. ==============
  69.  
  70.   SCALING:
  71.        When you have finished editing your graphics in your painting program, 
  72.        you should select a 40x40 region to paste back in.  Other sizes will
  73.        be scaled to fit, resulting in some distortion.
  74.        
  75.   COLORS:
  76.        Close Combat maintains a color palette of 256 colors that it uses during
  77.        the game.  You will not be able to use colors other than these...
  78.        
  79.        Furthermore, some of the colors are used for a programming technique
  80.        called "Color Palette Animation." This is used to make special effects,
  81.        such as the shimmering water.  If your colors are remapped onto one of
  82.        the colors used for this effect, you will notice it during the game.
  83.        
  84.        To help in selecting colors that are in the game, I have included a
  85.        palette for use with SuperPaint.  I'm not sure how to best import a
  86.        custom palette into Photoshop -- any suggestions?
  87.  
  88.        [v. 1.1:  For now, I have an "Export Color Table..." command from the
  89.         File menu.  Use this to create a PICT file with all of the colors in
  90.         it.  You can then use these colors within your drawing program.
  91.  
  92.         In reference to this color table, the animated colors are the last 5
  93.         entries of the 2nd row, the first 4 of the 3rd row, and the blue entry
  94.         in the 8th (final) row.  Note that all of these entries are blue--they
  95.         are used to create the waves and flowing river effects.]
  96.        
  97.   TREES:
  98.           Trees and a few other terrains are not simple tiles, but also have
  99.        associated  sprites for the foliage.  The editor does not currently
  100.        support editing these sprites... so there isn't much point in replacing
  101.        the tree stump graphics.
  102.   
  103.   
  104. NON-TRIVIAL EDITING:
  105. ====================
  106.   
  107.        CCLand allows you to change the graphics, but does not alter any of the
  108.        terrain statistics.  To do this, you will need a good text editor such as
  109.        BBEdit (you can download BBEdit Light at  http://www.barebones.com).
  110.        
  111.        To give a truly custom terrain type, you should not only edit the graphic,
  112.        but also the information for the tile, such as the movement rates,
  113.        obstruction, and so forth. Ideally, you will want to adjust the LOS file
  114.        for maps that use the custom terrain.  To do this, you will need to edit
  115.        CCCart's tile information database...
  116.        
  117.        The files you will want to edit are:
  118.             - Data/Base/Tiles
  119.             - CCCart Tile Info
  120.        you may want to edit:
  121.             - Data/Base/Elements
  122.             
  123.        
  124.        Editing Data/Base/Tiles:
  125.        ------------------------         
  126.           This file is Close Combat's tile database... 
  127.           The first column of numbers are the tile indices (the same # you
  128.           see in CCLand when you select a tile).
  129.           
  130.           The "i0" .. "i15" columns are the ones that you will want to
  131.           deal with.  The remaining columns are not functional, except for
  132.           the "Dam" column.  This entry indicates which tile should be
  133.           substituted if the tile is damaged (heavy shelling, etc.)
  134.           
  135.           The "i0".."i15" columns are the elements used within the tile.
  136.           They are arranged in a 4x4 grid:
  137.                i0   i1   i2   i3
  138.                i4   i5   i6   i7
  139.                i8   i9   i10  i11
  140.                i12  i13  i14  i15
  141.           The value in each entry tells Close Combat what type of terrain is
  142.           in that portion of the tile.  For example, Tile #8 (Vertical Stream):
  143.                0  13  13  0
  144.                0  13  13  0
  145.                0  13  13  0
  146.                0  13  13  0
  147.                
  148.           If you open the Data/Base/Elements file you will see that element #0
  149.           is "Grass" and that entry #13 is "Stream".
  150.           
  151.           SUGGESTION:  if possible, construct your custom tiles from existing
  152.                        elements that already capture the important effects.
  153.                        (eg, you may want to add a "DeadAndBloatedAnimal"
  154.                        but you could probably get away with just using the
  155.                        "DeadAnimal" element (#58).)
  156.  
  157.           
  158.        Editing Data/Base/Tiles:
  159.        ------------------------         
  160.           This data file is pretty well commented as it stands.
  161.           (I suggest importing this file into Excel to view it and print it...
  162.            although do NOT save it from Excel -- Excel will basically mess it up.
  163.            Use something like BBEdit for editing.)
  164.  
  165.  
  166.        Editing CCCart Tile Info:
  167.        -------------------------         
  168.           This file may be different for future versions of CCCart.
  169.           However, the basic item you want to look for is the Tile Information.
  170.           It will look something like:
  171.           
  172.                 //--------------------------                                
  173.                 // Tile Information                                
  174.                 //--------------------------                                
  175.                 Til    LOS Info    .    .    .    Type/Fill        Editor
  176. Info    Name
  177.                 Index    N/S    E/W    SE (\\)    SW
  178. (//)    type    fill    Damaged    
  179.                 &                                
  180.                 0    0    0    0    0    0    0    605    // Grass
  181.                 1    25    25    25    25    0    0    607    // High Grass
  182.                 2    0    0    0    0    0    0    2    // Dirt
  183.                 3    0    0    0    0    0    0    3    // Plowed
  184.                 4    25    25    25    25    0    0    608    // Wheat
  185.                 
  186.           The first column of numbers are the tile indices (the same # you
  187.           see in CCLand when you select a tile).  The 2nd-4th columns are
  188.           the LOS entries.  They are my own estimate for how much LOS
  189.           should be obstructed when passing through a tile in a given
  190.           direction.  A value of 0 is perfectly clear... a value of
  191.           100 will block (actually, this threshold is adjustable in 
  192.           CCCart Preferences).  Intermediate values will serve to contribute
  193.           towards an obstructed LOS.  Each of the columns corresponds
  194.           to a direction of looking through the terrain...
  195.           They are:  North to South (or vice versa), East-West,
  196.                      NorthWest - SouthEast, SouthWest - NorthEast.
  197.           For example, a horizontal wall will obstruct a North-South path,
  198.           but not obstruct much East-West.  It will probably obstruct a
  199.           lot of the diagonals as well...
  200.           (As a note:  this is my algorithm for calculating LOS files...
  201.            Atomic's is a lot more sophisticated... and several orders of
  202.            magnitude slower) 
  203.          
  204.          
  205. Acknowledgements:
  206. =================
  207.  
  208.   John Anderson (wargamer@atomic.com)
  209.         - a much-apprecaited source of information used in several of my
  210.           Close Combat editors.
  211.   Eckhardt Milz
  212.         - motivation for completing this project.
  213.   
  214. Who I Am:
  215. =========
  216.  
  217.   An EE graduate student, majoring in racquetball (I wish)... but mostly I'm
  218.   found in the cleanroom or some-such.  (My research is on micromachined 
  219.   electrodes for measuring nerve activity within the brain cortex.  I am
  220.   currently looking for a few good volunteers ;-)
  221.